Release 10.1A: OpenEdge Development:
Progress 4GL Reference

FILL( ) method

Fills a ProDataSet object, recursively, based on its defined data sources, data relations, and queries. You can fill a ProDataSet object completely by starting at the top level and traversing through each of its member buffers, or partially by starting at the level of one of its member buffers.

Return type: LOGICAL

Applies to: ProDataSet object handle, Buffer object handle

Syntax

FILL( )

You can define a query for the data source of a ProDataSet member buffer at any level of the ProDataSet object to select the records to fill in one FILL operation. You can also use the FILL-WHERE-STRING attribute to override the WHERE clause in the query for the data source during a FILL operation.

You can perform a FILL operation on a ProDataSet object or one of its member buffer objects any number of times. You might do this, for example, to load data in a ProDataSet object or buffer after you have modified a Data-source object query or attached to a different Data-source object.

You can specify the FILL mode to direct the FILL operation for a ProDataSet member buffer using the FILL-MODE attribute. The default FILL-MODE is MERGE.

For more information about filling a ProDataSet object, see OpenEdge Development: ProDataSets .

If successful, this method returns TRUE. Otherwise, it returns FALSE.

If Progress encounters an error, it sets the value of the ERROR attribute to TRUE for the associated ProDataSet object handle and Temp-table object handle.

See also

ATTACH-DATA-SOURCE( ) method, BATCH-SIZE attribute, CREATE DATASET statement, CREATE DATA-SOURCE statement, DEFINE DATASET statement, DEFINE DATA-SOURCE statement, FILL events, FILL-MODE attribute, FILL-WHERE-STRING attribute, LAST-BATCH attribute, NEXT-ROWID attribute, RESTART-ROWID attribute, SET-CALLBACK-PROCEDURE( ) method